home *** CD-ROM | disk | FTP | other *** search
/ JCSM Shareware Collection 1996 September / JCSM Shareware Collection (JCS Distribution) (September 1996).ISO / screenut / gemcap.zip / GEMCAP.DOC < prev    next >
Text File  |  1993-03-07  |  20KB  |  597 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.                                    GEMCAP (TM)
  13.  
  14.  
  15.  
  16.  
  17.  
  18.                                    USER MANUAL
  19.  
  20.  
  21.  
  22.  
  23.                             (C) Copyright 1985 - 1993
  24.                                All Rights Reserved
  25.  
  26.                                 Natural Software
  27.                               19 South Fifth Street
  28.                               St. Charles, IL 60174
  29.                                  (708) 377-7320
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.      LICENSE
  38.  
  39.      THE GEMCAP SOFTWARE AND MANUAL ARE COPYRIGHTED, ALL RIGHTS ARE RESE-
  40.      RVED. YOU HAVE PURCHASED A LICENSE TO USE THIS SOFTWARE ON ONE MACHINE
  41.      AT A TIME. YOU ARE AUTHORIZED TO MAKE COPIES OF GEMCAP FOR THE SOLE
  42.      PURPOSE OF BACKING UP YOUR SOFTWARE AND PROTECTING YOUR INVESTMENT
  43.      FROM LOSS.
  44.  
  45.      Note: this copy of GEMCAP is being distributed as ShareWare. This
  46.      means that you may copy the disk just as you received it and you may
  47.      give it to others for their trial use. You are also permitted and
  48.      encouraged to upload this version to electronic bulletin board servic-
  49.      es. You may not, however resell or collect any fee for the distribu-
  50.      tion of GEMCAP without the permission of Natural Software. (This does
  51.      not include the normal fees for using bulletin boards.) If you contin-
  52.      ue to use GEMCAP after your trial use, you must pay the purchase price
  53.      as detailed below.
  54.  
  55.      WARRANTY
  56.  
  57.      THIS SOFTWARE WILL PERFORM AS DESCRIBED HEREIN ONLY IF PROPERLY AP-
  58.      PLIED. OUR LIABILITY TO YOU IS LIMITED TO REPLACING THE SOFTWARE (FOR
  59.      REGISTERED USERS ONLY). WE HAVE NO LIABILITY TO YOU FOR ANY DAMAGE OR
  60.      LOSS, INCLUDING SPECIAL, INCIDENTAL, OR CONSEQUENTIAL, CAUSED BY THIS
  61.      SOFTWARE, DIRECTLY OR INDIRECTLY.
  62.  
  63.      YOU AGREE TO THE TERMS OF THIS LICENSE BY YOUR DECISION TO USE THIS
  64.      SOFTWARE.
  65.  
  66.  
  67.                _______                       This program is produced by
  68.           ____|__     |               (tm)   a member of the Association
  69.        --|       |    |-------------------   of Shareware Professionals
  70.          |   ____|__  |  Association of      (AS). ASP wants to make sure
  71.          |  |       |_|  Shareware           that the shareware principle
  72.          |__|   o   |    Professionals       works for you. If you are
  73.        -----|   |   |---------------------   unable to resolve a shareware
  74.             |___|___|    MEMBER              related problem with an ASP
  75.                                        member by contacting the member
  76.                                              directly, ASP may be able to
  77.      help. The ASP Ombudsman can help you resolve a dispute or problem with
  78.      an ASP member, but does not provide technical support for members'
  79.      products. Please write to the ASP Ombudsman at 545 Grover Road, Musk-
  80.      kegon, MI 49442-9427 or send a Compuserve message to ASP Ombuds-
  81.      man 70007,3536"
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.                                 Table of contents
  90.  
  91.      Introduction  . . . . . . . . . . . . . . . . . . . . . . . . .    iii
  92.         ShareWare  . . . . . . . . . . . . . . . . . . . . . . . . . .    2
  93.  
  94.      Using GEMCAP  . . . . . . . . . . . . . . . . . . . . . . . . . .    3
  95.         Starting GEMCAP  . . . . . . . . . . . . . . . . . . . . . . .    3
  96.         The Hot Key  . . . . . . . . . . . . . . . . . . . . . . . . .    3
  97.         Customizing the Hot Key  . . . . . . . . . . . . . . . . . . .    4
  98.         Removing GEMCAP  . . . . . . . . . . . . . . . . . . . . . . .    6
  99.  
  100.      Text Mode Screens . . . . . . . . . . . . . . . . . . . . . . . .    7
  101.         Text mode fonts  . . . . . . . . . . . . . . . . . . . . . . .    7
  102.         Image Size . . . . . . . . . . . . . . . . . . . . . . . . . .    8
  103.  
  104.      Graphic Mode Screens  . . . . . . . . . . . . . . . . . . . . . .    9
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.                                        ii
  137.  
  138.  
  139.  
  140.  
  141.  
  142.  
  143.  
  144.  
  145.                                   Introduction
  146.  
  147.  
  148.  
  149.      GEMCAP.COM is a Terminate and Stay Resident (TSR) program that cap-
  150.      tures screen images from other programs. It saves these images in
  151.      separate GEM .IMG files. In the case of text based screens, the text
  152.      is converted to a bitmap. The GEM .IMG graphic file format is one of
  153.      the several "standard" formats that many other programs can read. The
  154.      primary use of GEMCAP is to incorporate screen images into desktop
  155.      publishing documents. Both Ventura Publisher and WordPerfect version
  156.      5.0 (and 5.1) can read GEM .IMG format.
  157.  
  158.      GEMCAP supports a variety of display adaptors and different display
  159.      modes:
  160.  
  161.      Monochrome   Standard IBM monochrome display adaptors support text
  162.                   modes only. GEMCAP will capture text mode displays and
  163.                   convert them to bitmap files. To use the resulting .IMG
  164.                   files, however you must have some type of display adaptor
  165.                   that can display graphics.
  166.  
  167.      CGA          On IBM Color Graphics Adapters (CGA), the high resolution
  168.                   640 by 200 pixel (mode 6) is supported in addition to the
  169.                   various text modes.
  170.  
  171.      EGA          GEMCAP can capture EGA 640 by 350 pixel 16 color (mode
  172.                   10h) graphics screens.
  173.  
  174.      VGA          GEMCAP can capture VGA 640 by 480 pixel 16 color (mode
  175.                   12h) graphics screens.
  176.  
  177.      Hercules     GEMCAP will not work on Hercules displays in graphics
  178.                   mode. It will capture text mode screens from Hercules.
  179.                   You can use your desktop publishing program to use the
  180.                   resulting GEM .IMG files with Hercules displays.
  181.  
  182.      On EGA and VGA displays in text mode, GEMCAP uses the RAM resident
  183.      font to convert the screen to a bitmap. This means that the resulting
  184.      bitmap represents the captured text screen exactly as it appears on
  185.      the screen, even if the program loads a specialized font.
  186.  
  187.  
  188.  
  189.  
  190.  
  191.      Introduction                                                                       1
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.      ShareWare
  200.  
  201.      The GEMCAP package is being distributed as shareware. This means that
  202.      it is not free. This means that you must pay to use it. However, you
  203.      do not have to pay to try it, test it, and to determine if it is going
  204.      to be useful to you. You are probably familiar with the concept by
  205.      now. ShareWare programs give you the advantage of "test driving" them.
  206.      The advantage to the developer is a relatively inexpensive distribu-
  207.      tion method. For this concept to work and keep working for our mutual
  208.      advantage, you really must register and pay for the software you
  209.      actually find useful.
  210.  
  211.      Please feel free to pass along a copy of this disk to others for their
  212.      trial use. But please distribute it in its original unaltered state.
  213.      The compressed arc file: GEMCAP.ARC is intended for uploading to your
  214.      local bulletin boards.
  215.  
  216.      To register your use of GEMCAP, send $35.00 to Natural Software at the
  217.      address above. This entitles you to one upgrade to the next new
  218.      release for free (please specify the version you currently have when
  219.      registering). We will also send you a description of our other soft-
  220.      ware offerings (including PC-Draft II which lets you edit and enhance
  221.      your captured images) and provide free telephone support as needed.
  222.  
  223.      Users in the United Kingdom should register with our UK distributor:
  224.  
  225.                                                    ElectronArt Design Ltd
  226.         Please call for price in pounds            78 Kimberley Avenue
  227.         sterling or mail/FAX the Order Form.       ILFORD  ESSEX  IG2 7AS
  228.                                                    ENGLAND
  229.                                                    Phone/FAX 081-983 8686  
  230.                                                    E-mail CIS 100023,1267
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.      2                                                                             GEMCAP
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.                                   Using GEMCAP
  256.  
  257.  
  258.      GEMCAP is a Terminate and Stay Resident (TSR) program. When you run it
  259.      from the DOS command line, it will announce its presence and quietly
  260.      sink into the background and wait to be called into action (when its
  261.      "hot key" is pressed).
  262.  
  263.      Starting GEMCAP
  264.  
  265.      When you run GEMCAP, you must provide it with the location and start-
  266.      ing file name to use to store the screen images it captures. For
  267.      example, you might start GEMCAP with this command:
  268.  
  269.              GEMCAP C:\SCREENS\SCREENA.IMG
  270.  
  271.      Now GEMCAP will store its screens in the SCREENS sub-directory. Note
  272.      that the SCREENS sub-directory must already exist. The first screen it
  273.      saves will be called SCREENA.IMG, the second will be called
  274.      SCREENB.IMG. Each subsequent .IMG file will increment the character in
  275.      the filename just before the extension. These files are graphic bit
  276.      image files compatible with any program that reads GEM .IMG files,
  277.      regardless of whether the original screen was in text mode or graphics
  278.      mode.
  279.  
  280.      Note that this convention (of incrementing the last character in the
  281.      filename for each file) limits you to 26 screen saves at a time. This
  282.      is because if you start with the letter A, it will cycle through the
  283.      alphabet until it gets to Z, then the next character in ASCII sequence
  284.      is a "[", which is invalid for a filename. If you need more than 26
  285.      files, you must remove GEMCAP from memory and reload it with a differ-
  286.      ent initial filename.
  287.  
  288.  
  289.      The Hot Key
  290.  
  291.      To activate GEMCAP and save the current screen to a .IMG file, you
  292.      Press the (Alt + .) keys (that's the period key and the Alt key) togeth-
  293.      er. You will hear a beep when GEMCAP is called. Three beeps means it
  294.      successfully wrote an .IMG file to the specified directory. Only one
  295.      beep means it was unable to create the file (could not find the
  296.      directory?). Only two beeps means it created the file, but could not
  297.      write the full screen buffer, (disk full?).
  298.  
  299.  
  300.  
  301.      Introduction                                                                       3
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.      The size of the file GEMCAP creates depends on the current display
  310.      mode. 
  311.  
  312.      GEMCAP will detect the current video mode and adjust. It converts text
  313.      mode screens into bit mapped graphics.
  314.  
  315.      Like any other TSR, GEMCAP may have compatibility problems with other
  316.      software, especially other TSR's. If you have trouble, try installing
  317.      GEMCAP by itself and adding your other TSR utilities one at a time
  318.      after you get GEMCAP to work.
  319.  
  320.  
  321.      Customizing the Hot Key
  322.  
  323.      If you have a conflict with other resident programs, you may need to
  324.      change GEMCAP's hot key. You must use DEBUG to make the change. There
  325.      are two bytes in the GEMCAP.COM file that may be changed. The first
  326.      byte represents the keyboard scan code and the second byte represents
  327.      the shift key state. The following two tables show the values (in
  328.      hexadecimal) for all the possible keyboard scan codes and shift key
  329.      states. After consulting the tables, use DEBUG to enter the values as
  330.      shown below (for example to change the hot key to (Ctrl+Z):
  331.  
  332.         DEBUG GEMCAP.COM
  333.         E xxxx:0103
  334.         xxxx:0103 34.2C    ; shows existing scan code, enter new code: 2C
  335.                              (for Z)
  336.         E xxxx:0104
  337.         xxxx:0104 08.04    ; shows existing shift state, enter new code: 04
  338.                              (for Ctrl)
  339.         W                  ; save changes
  340.         Q                  ; quit DEBUG
  341.  
  342.  
  343.      This table shows keyboard scan codes for alternate hot keys:
  344.  
  345.      Key       Hex    Key     Hex    Key       Hex
  346.  
  347.      Esc        01    Enter    1C    PrtSc     37
  348.      !1         02    Ctrl     1D    Alt       38
  349.      @2         03    A        1E    Space     39
  350.      #3         04    S        1F    CapLk     3A
  351.      $4         05    D        20    F1        3B
  352.  
  353.  
  354.      4                                                                             GEMCAP
  355.  
  356.  
  357.      Key       Hex    Key     Hex    Key       Hex
  358.  
  359.      %5         06    F        21    F2        3C
  360.      ^6         07    G        22    F3        3D
  361.      &7         08    H        23    F4        3E
  362.      *8         09    J        24    F5        3F
  363.      (9         0A    K        25    F6        40
  364.      )0         0B    L        26    F7        41
  365.      _-         0C    :;       27    F8        42
  366.      +=         0D    "'       28    F9        43
  367.      backsp     0E    ~`       29    F10       44
  368.      tab        0F    L Sft    2A    NumLk     45
  369.      Q          10    |\       2B    ScrLk     46
  370.      W          11    Z        2C    Home      47
  371.      E          12    X        2D    Up        48
  372.      R          13    C        2E    PgUp      49
  373.      T          14    V        2F    -         4A
  374.      Y          15    B        30    Left      4B
  375.      U          16    N        31    5         4C
  376.      I          17    M        32    Right     4D
  377.      O          18    <,       33    +         4E
  378.      P          19    >.       34    End       4F
  379.      {[         1A    ?/       35    Down      50
  380.      }]         1B    RSHFT    36    PgDn      51
  381.  
  382.      The following table shows the hexadecimal values for the possible
  383.      shift key states:
  384.  
  385.  
  386.                                                                               Shift    Shift
  387.  
  388.  
  389.  
  390.      Introduction                                                                       5
  391.  
  392.  
  393.     Shift key value    Alt    Ctrl     Left     Right
  394.            0
  395.            1                                      X
  396.            2                             X
  397.            3                             X        X
  398.            4                    X                   
  399.            5                    X                 X
  400.            6                    X        X
  401.            7                    X        X        X
  402.            8            X
  403.            9            X                         X
  404.            A            X                X
  405.            B            X                X        X
  406.            C            X       X
  407.            D            X       X                 X
  408.            E            X       X        X
  409.            F            X       X        X        X
  410.  
  411.  
  412.  
  413.      Removing GEMCAP
  414.  
  415.      You can remove GEMCAP from memory by running GEMCAP with a command
  416.      line argument: -U. for example:
  417.  
  418.           GEMCAP  -U
  419.  
  420.      GEMCAP must be the last TSR program loaded for this to work properly.
  421.      By removing and then reloading GEMCAP you can change the filename so
  422.      that you can save more than 26 screens.
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430.      6                                                                             GEMCAP
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.                                 Text Mode Screens
  440.  
  441.  
  442.      When the screen is in text mode when GEMCAP is run, it converts each
  443.      screen character to a bitmap. This means that when you display or
  444.      print the resulting GEM .IMG files with your desktop publishing
  445.      program, you will get exactly what is displayed on the screen.
  446.  
  447.      Text mode fonts
  448.  
  449.      With monochrome, CGA, or Hercules display adaptors, an internal
  450.      (within GEMCAP.COM) 8 by 8 pixel font is used.
  451.  
  452.      On EGA or VGA display adaptors, the RAM resident font (on the EGA or
  453.      VGA adaptor) is used.
  454.  
  455.      GEMCAP does not produce color GEM .IMG files. It converts color
  456.      attributes to monochrome (Black & White) as described below.
  457.  
  458.      GEMCAP converts reverse video areas of the screen appropriately. Any
  459.      color attribute combination that results in darker characters with a
  460.      lighter background will be converted to reverse video.  You can
  461.      disable this conversion by running GEMCAP with the command line
  462.      option: -M for Monochrome mode. The following color attribute combina-
  463.      tions on the captured screen will result in reverse video:
  464.  
  465.         any of these background  With these foreground
  466.         -----------------------  ---------------------
  467.         green                    black     grey
  468.         cyan                     blue      lt blue
  469.         brown                    red       lt red
  470.         white                    magenta   lt magenta
  471.  
  472.      If you wish to reverse the entire screen, for example from white on
  473.      black to black on white, load GEMCAP with the following command line
  474.      argument (-R) as shown below:
  475.  
  476.         GEMCAP -R C:\SCREENS\SCREENA.IMG
  477.  
  478.      To turn off conversion to reverse video use the (-M) command line
  479.      argument. For example to have all black characters on an all white
  480.      background (regardless of the actual screen colors) use:
  481.  
  482.         GEMCAP -M -R C:\SCREENS\SCREENA.IMG
  483.  
  484.  
  485.      Text Mode                                                                          7
  486.  
  487.  
  488.  
  489.  
  490.  
  491.  
  492.  
  493.  
  494.      GEMCAP will correctly capture different sized text mode screens. For
  495.      example, it can handle EGA text mode screens with 43 lines and VGA
  496.      text mode screens with 50 lines. It adjusts the internal pixel size so
  497.      that screens with different numbers of lines will display with the
  498.      correct aspect ratio.
  499.  
  500.  
  501.      Image Size
  502.  
  503.      Note that with Ventura Publisher or WordPerfect 5.0, the size of the
  504.      image when incorporated into your document is dependent on the size of
  505.      the frame (VP) or figure (WP). For best results, you must adjust this
  506.      size (within VP or WP) so that pixels are not truncated or compressed.
  507.      You can calculate the best size for the image in your document based
  508.      on the horizontal and vertical resolution of your printer. For example
  509.      lets say you capture a VGA text mode screen that has 80 columns and 25
  510.      lines. The font size in this mode is 8 by 16 pixels. This means that
  511.      there are 400 (16 times 25) scan lines in the image and it is 640
  512.      pixels horizontally (80 times 8). You must size the image so that the
  513.      number if pixels in the image is evenly divisible by the printer
  514.      resolution. Therefore, if you have a laser printer or DeskJet printer
  515.      that prints at a resolution of 300 dots per inch (both horizontal and
  516.      vertical), a frame size  of 2.13 inches by 1.33, or 4.27 inches by
  517.      2.67 inches would produce non-distorted output. Note that you must
  518.      account for the inside border space and border width when sizing
  519.      figures in WordPerfect.
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.  
  536.  
  537.  
  538.  
  539.  
  540.      8                                                                             GEMCAP
  541.  
  542.  
  543.  
  544.  
  545.  
  546.  
  547.  
  548.  
  549.                               Graphic Mode Screens
  550.  
  551.  
  552.      When the screen is in a graphics mode, GEMCAP stores the image pixel
  553.      by pixel in the GEM .IMG file. The most common high resolution graph-
  554.      ics modes of the various display adaptors are supported as follows:
  555.  
  556.              CGA  640 x 200 x 2 color (mode 06h)
  557.              EGA  640 x 350 x 16 color (mode 10h)
  558.              VGA  640 x 480 x 16 color (mode 12h)
  559.  
  560.      Since GEMCAP does not produce color GEM .IMG files, when EGA/VGA 16
  561.      color modes are detected, it converts the color to monochrome (Black &
  562.      White) as described below.
  563.  
  564.              These dark colors are converted to Black:
  565.  
  566.                Black     Gray
  567.                Blue      Hi-intensity Blue
  568.                Green     Hi-intensity Green
  569.                Cyan      Hi-intensity Cyan
  570.  
  571.              These light colors are converted to White:
  572.  
  573.                Red       Hi-intensity Red
  574.                Violet    Hi-intensity Violet
  575.                Yellow    Hi-intensity Yellow
  576.                White     Hi-intensity White
  577.  
  578.      The size of the GEM .IMG file will vary. GEMCAP compresses the data in
  579.      the file as much as possible (for GEM .IMG file formats) by checking
  580.      for duplicate scan lines in the original image. The more complex the
  581.      image, the larger the file size.
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.      Graphics Mode                                                                      9
  596.  
  597.